home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / bbsext19.arc / BBSEXTRA.DOC next >
Text File  |  1991-09-29  |  4KB  |  91 lines
  1.  
  2. BBSEXTRA Utility                                                    Version 1.9
  3. ----------------                                                   Sep  2, 1991
  4.  
  5. Purpose:        BBSEXTRA compares the files listed in your PCBoard
  6.                 directory listings (DIRnn files) to the files that
  7.                 actually exist in your download paths.
  8.  
  9.                 BBSEXTRA produces reports of files that are missing,
  10.                 extra, or duplicated.
  11.  
  12. Syntax:         BBSEXTRA  [d:\path]  [/T]
  13.  
  14.  
  15.                 where d:\path specifies the drive and path to be used
  16.                 for temporary work files. The default is to place the
  17.                 work files in the current directory. About 100 bytes
  18.                 per file and DIR file entry is required; usually
  19.                 several hundred K-bytes.
  20.  
  21.                 Specify /T to display the names of files in the DIRnn
  22.                 listings and in disk subdirectories.
  23.  
  24. Input:          Two control files are required:
  25.  
  26.                 1)  DRVDIRS
  27.  
  28.                    This file contains a list of download paths. Be
  29.                    sure to include all of your upload directories
  30.                    and conference directories. For example:
  31.  
  32.                         W:\UPLOADS\
  33.                         V:\ME\
  34.                         V:\M1\
  35.                         J:\L22\
  36.  
  37.                 2)  FILEDIRS
  38.  
  39.                    This file contains a list of directory listing
  40.                    files. For example:
  41.  
  42.                         c:\dir\dir29
  43.                         v:\pcb\main\dir30
  44.  
  45. |                  Each entry in the directory listing file must contain
  46. |                  a valid file name starting in column 1. The file name
  47. |                  may be in the form 'ffffffff.ext' or 'ffffffff ext'.
  48. |                  The file name should be followed by a file size. The
  49. |                  output of the DOS DIR command is an acceptable format.
  50.  
  51. Output:         These files are created:
  52.  
  53.                 MISSING         - a list of missing files; those
  54.                                   listed in DIRnn files, but not
  55.                                   found in any download path
  56.  
  57.                 EXTRA           - a list of files found in a download
  58.                                   path, but not listed in a DIRnn file.
  59.  
  60.                 DUPES           - a list of files of the same name
  61.                                   found in more than one download path
  62.  
  63.                 Four large temporary files (30-40 bytes per file entry)
  64.                 are created.  Use a RAM disk if you can.
  65.  
  66. Operation:      BBSEXTRA builds a list of all files contained in the
  67.                 download paths and writes the list to a temporary
  68.                 file called BBSEXTT1.}}}.  Then, all file names listed
  69.                 in the DIRnn files are written to the temporary file
  70.                 called BBSEXTT2.}}}.  The two temporary files are
  71.                 sorted, and then compared for missing, extra, and
  72.                 extra files.
  73.  
  74.                 The EXTRA files may be removed by passing the file to
  75.                 a utility like PCOPY or PMOVE. For example:
  76.  
  77.                         PCOPY @EXTRA C:\DELETED /X
  78.  
  79.                 to move all unlisted files to the C:\DELETED directory.
  80.                 It's best to save any extra files, rather than simply
  81.                 deleting them.
  82.  
  83. Requirements:   BBSEXTRA needs the SORTF utility sort program.
  84.  
  85. Notes:          Written using the MS BASIC Compiler PDS Version 7.1 and
  86.                 one assembler subroutine.
  87.                 For personal use only. May not be sold.
  88.  
  89.                 BBSEXTRA Copyright (c) Vernon D. Buerg 1989-1991
  90.  
  91.